/*
 * Copyright 2002-2006 the original author or authors. Licensed under the Apache License, Version 2.0 (the "License");
 * you may not use this file except in compliance with the License. You may obtain a copy of the License at
 * http://www.apache.org/licenses/LICENSE-2.0 Unless required by applicable law or agreed to in writing, software
 * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND,
 * either express or implied. See the License for the specific language governing permissions and limitations under the
 * License.
 */
package pikes.html.xhtml;

import java.util.LinkedList;
import java.util.List;

import pikes.xml.XMLTag;

/**
 * <code>&lt;span/&gt;</code> tag, see <a href="http://www.w3.org/TR/html401/struct/global.html#h-7.5.4">DIV element</a>
 * in HTML specification.
 * @author Peter Bona
 * @see <a href="http://www.w3.org/TR/html401/struct/global.html#h-7.5.4">The DIV element in HTML specification</a>
 */
public class Span extends NonRootTagFactory implements Special, CoreAttributes, I18N, Events, InlineList {

	private List<Inline> inlines = new LinkedList<Inline>();

	/**
	 * Creates an empty span element
	 */
	public Span() {
		// left intentionally empty
	}

	/**
	 * Creates a span element with the given inline element as first item
	 * @param inline The first element in the content list
	 */
	public Span(Inline inline) {
		if (inline != null) {
			inlines.add(inline);
		}
	}

	/**
	 * Creates a span element with the given string as first item
	 * @param text The first element in the content list
	 */
	public Span(CharSequence text) {
		if (text != null) {
			inlines.add(new PCData(text));
		}
	}

	/**
	 * @return "span"
	 */
	@Override
	final protected CharSequence getTagName() {
		return "span";
	}

	/**
	 * Adds an inline to the content list
	 * @param inline inline to be added
	 */
	final public void add(Inline inline) {
		if (inline != null) {
			inlines.add(inline);
		}
	}

	public void add(CharSequence text) {
		if (text != null) {
			inlines.add(new PCData(text));
		}
	}

	/**
	 * Delegates the decoration to the added inline elements.
	 * @param tag the parent tag to be decorated
	 */
	@Override
	final protected void decorateCreatedTag(XMLTag tag) {
		for (Inline inline : inlines) {
			inline.decorateTag(tag);
		}
	}

}
